<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">











<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>NPanday - </title>
    <style type="text/css" media="all">
      @import url("./css/maven-base.css");
      @import url("./css/maven-theme.css");
      @import url("./css/site.css");
    </style>
    <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
      </head>
  <body class="composite">
    <div id="banner">
                    <span id="bannerLeft">
    
            NPanday :: WSDL Maven Plugin
    
            </span>
                    <div class="clear">
        <hr/>
      </div>
    </div>
    <div id="breadcrumbs">
          
  

  
    
  
  
    
            <div class="xleft">
        Last Published: 2010-06-22
                      </div>
            <div class="xright">            <a href="http://incubator.apache.org/projects/npanday.html" class="externalLink">Project Site</a>
            |
                <a href="http://incubator.apache.org/npanday" class="externalLink">NPanday</a>
            |
                <a href="http://svn.apache.org/repos/asf/incubator/npanday/" class="externalLink">NPanday SVN</a>
            |
                <a href="http://maven.apache.org/" class="externalLink">Maven</a>
            |
                <a href="http://www.mono-project.com/" class="externalLink">Mono Project</a>
            |
                <a href="http://dotgnu.org/" class="externalLink">DotGNU</a>
            
  

  
    
  
  
    
  </div>
      <div class="clear">
        <hr/>
      </div>
    </div>
    <div id="leftColumn">
      <div id="navcolumn">
           
  

  
    
  
  
    
                   <h5>General Info</h5>
            <ul>
              
    <li class="none">
                    <a href="index.html">About</a>
          </li>
              
    <li class="none">
                    <a href="plugin-info.html">Goals</a>
          </li>
              
    <li class="none">
              <strong>Usage</strong>
        </li>
          </ul>
              <h5>Project Documentation</h5>
            <ul>
              
                
              
      
              
        <li class="collapsed">
                    <a href="project-info.html">Project Information</a>
                </li>
              
                
              
      
            
      
              
        <li class="collapsed">
                    <a href="project-reports.html">Project Reports</a>
                </li>
          </ul>
                                           <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
            <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
          </a>
                       
  

  
    
  
  
    
        </div>
    </div>
    <div id="bodyColumn">
      <div id="contentBox">
        <div class="section"><h2>Configuration</h2>
<p>The WSDL plugin will use the path environmental variable to choose the WSDL generator - MONO or Microsoft. Within the path field, specify the location of your WSDL file. If you need to specifically choose the vendor yourself, and not rely on the path, add the netHome field. The path is the only required field. You can optionally add the netHome, language, namespace, server and proxy.</p>
<div class="source"><pre>
    &lt;build&gt;
        &lt;plugins&gt;
            &lt;plugin&gt;
                &lt;groupId&gt;npanday.plugin&lt;/groupId&gt;
                &lt;artifactId&gt;maven-wsdl-plugin&lt;/artifactId&gt;
                &lt;executions&gt;
                    &lt;execution&gt;
                        &lt;goals&gt;
                            &lt;goal&gt;wsdl&lt;/goal&gt;
                        &lt;/goals&gt;
                    &lt;/execution&gt;
                &lt;/executions&gt;
                &lt;configuration&gt;
                    &lt;netHome&gt;${MONO_HOME}&lt;/netHome&gt;
                    &lt;language&gt;CS&lt;/language&gt;
                    &lt;namespace&gt;org.apache.maven.test&lt;/namespace&gt;
                    &lt;paths&gt;
                        &lt;path&gt;HelloService.wsdl&lt;/path&gt;
                    &lt;/paths&gt;
                    &lt;server&gt;
                        &lt;id&gt;nmaven-site&lt;/id&gt;
                        &lt;hashPassword&gt;true&lt;/hashPassword&gt;
                        &lt;hashAlg&gt;MD5&lt;/hashAlg&gt;
                    &lt;/server&gt;
                    &lt;proxy&gt;
                        &lt;id&gt;my-proxy&lt;/id&gt;
                    &lt;/proxy&gt;
                        &lt;/configuration&gt;
            &lt;/plugin&gt;
        &lt;/plugins&gt;
    &lt;/build&gt;
</pre>
</div>
</div>
<div class="section"><h2>Handling Servers and Proxies</h2>
<p>The WSDL generation utility allows you to pull the WSDL from a URL. In some case, these URLs may be located behind a proxy and/or require some form of authentication. It is generally not good pratice to embed the username/passwords in the configuration files that you may be distributing or putting under version control. Use the maven settings.xml file to keep this information locally (typically located under $<a name="USER_HOME">USER_HOME</a>/.m2). The server.id and proxy.id map the username/password to the configuration of the WSDL plugin.</p>
<p>There is an experimental feature to hash the password (does not work in all cases due to encoding issues).</p>
<div class="source"><pre>
&lt;settings&gt;
        &lt;servers&gt;
                &lt;server&gt;
                        &lt;id&gt;nmaven-site&lt;/id&gt;
                        &lt;username&gt;name&lt;/username&gt;
                        &lt;password&gt;pass&lt;/password&gt;
                &lt;/server&gt;
        &lt;/servers&gt;
        &lt;proxies&gt;
                &lt;proxy&gt;
                        &lt;id&gt;my-proxy&lt;/id&gt;
                        &lt;username&gt;name1&lt;/username&gt;
                        &lt;password&gt;password1&lt;/password&gt;
                        &lt;host&gt;localhost&lt;/host&gt;
                &lt;/proxy&gt;
        &lt;/proxies&gt;
&lt;/settings&gt;
</pre>
</div>
</div>

      </div>
    </div>
    <div class="clear">
      <hr/>
    </div>
    <div id="footer">
      <div class="xright">&#169;  
          2010
    
          NPanday
          
  

  
    
  
  
    
  </div>
      <div class="clear">
        <hr/>
      </div>
    </div>
  </body>
</html>
